Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Managing Groups

Q3Group_AddObject

You can use the Q3Group_AddObject function to add an object to a group.

TQ3GroupPosition Q3Group_AddObject (
TQ3GroupObject group, 
TQ3Object object);

group

A group.

object

An object.

DESCRIPTION

The Q3Group_AddObject function inserts the object specified by the object parameter into the group specified by the group parameter. If group is a unordered group, the object is appended to the list of objects in the group. If group is an ordered group, the object is appended to the part of the list of objects in the group that are of the same type as object. Q3Group_AddObject returns the new position of the object in the group. If an error occurs as an object is inserted into the group, Q3Group_AddObject returns NULL.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorOutOfMemory